W07-1. Deployment - 강의 노트

7주차 강의 노트: Deployment (자가 치유 · 스케일링 · 롤링 업데이트 · 롤백)

이번 주 목표

  1. Deployment → ReplicaSet → Pod 의 관계를 설명할 수 있다.
  2. Pod 를 지워도 스스로 되살아나는 원리(조정 루프 + 라벨)를 안다.
  3. 롤링 업데이트가 무중단으로 버전을 바꾸는 과정을 설명할 수 있다.
  4. 잘못 배포했을 때 롤백할 수 있다.

진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)

지난주 복습

  • Kubernetes = 원하는 상태를 선언하면 조정 루프가 맞춰 줌
  • Pod = 가장 작은 단위. 직접 만든 Pod 는 지우면 그대로 사라짐


1. Deployment 가 하는 일

Deployment 는 "이 Pod 를 항상 N개 유지하고, 버전을 바꿀 때는 안전하게 바꿔 줘" 라고 선언하는 오브젝트입니다. 실무에서 앱(웹, API 등)을 띄울 때 가장 많이 쓰는 방법입니다.

flowchart TB
    D["Deployment: guestbook
replicas: 3, image: v1
(버전 관리 담당)"] --> RS["ReplicaSet: guestbook-6694d9fcc5
'app=guestbook Pod 를 3개 유지'
(개수 담당)"] RS --> P1["Pod
guestbook-6694d9fcc5-8f9bh"] RS --> P2["Pod
guestbook-6694d9fcc5-pwp8r"] RS --> P3["Pod
guestbook-6694d9fcc5-zlp58"]
오브젝트 책임 우리가 직접 만드나?
Deployment 버전 관리: 업데이트 방식, 이력, 롤백 ✅ (YAML 로)
ReplicaSet 개수 관리: "라벨이 맞는 Pod 를 N개 유지" ❌ (Deployment 가 자동 생성)
Pod 실제 컨테이너 실행 ❌ (ReplicaSet 이 자동 생성)
이름을 보면 관계가 보입니다

guestbook-6694d9fcc5-8f9bh = Deployment 이름 + ReplicaSet 고유 번호 + Pod 고유 번호
ReplicaSet 번호는 Pod 설계도(template)의 지문입니다. 이미지 버전이 바뀌면 지문이 바뀌어 새 ReplicaSet 이 생깁니다.


2. Deployment YAML 읽기

apiVersion: apps/v1                 # Deployment 는 apps/v1
kind: Deployment
metadata:
  name: guestbook
  annotations:
    kubernetes.io/change-cause: "v1 최초 배포"   # 배포 이력에 남길 메모
spec:
  replicas: 3                       # ① 몇 개 유지할지
  selector:
    matchLabels:
      app: guestbook                # ② "이 라벨이 붙은 Pod 가 내 것"
  template:                         # ③ Pod 설계도 (6주차 pod.yaml 의 내용이 여기로)
    metadata:
      labels:
        app: guestbook              #    ②와 반드시 같아야 함
    spec:
      containers:
        - name: web
          image: 내아이디/guestbook:v1
          ports:
            - containerPort: 8000
부분 의미
replicas 원하는 Pod 개수
selector.matchLabels 어떤 Pod 를 내 것으로 셀지 정하는 조건
template 새 Pod 를 만들 때 쓰는 설계도. 6주차 pod.yaml 의 metadata + spec 과 같은 모양
template.metadata.labels 만들어질 Pod 에 붙일 라벨. selector 와 일치해야 합니다 (안 맞으면 apply 할 때 에러)

3. 자가 치유: 라벨로 세고, 모자라면 만든다

ReplicaSet 의 조정 루프는 아주 단순합니다.

flowchart LR
    C["app=guestbook 라벨이 붙은
Pod 개수 세기"] --> Q{"원하는 개수(3)와
같은가?"} Q -- "2개 (하나 죽음)" --> A["1개 새로 만들기"] Q -- "4개 (하나 많음)" --> B["1개 지우기"] Q -- "3개" --> C A --> C B --> C
상황 ReplicaSet 의 반응
Pod 하나를 지웠다 / 앱이 죽었다 2개 → 새로 1개 생성 (새 이름, 새 IP)
노드(서버) 하나가 고장 났다 그 노드의 Pod 가 사라짐 → 다른 노드에 새로 생성
Pod 의 라벨을 바꿨다 라벨이 다르니 "내 것이 아님" → 2개로 세고 새로 1개 생성. 라벨을 바꾼 Pod 는 관리 밖으로 빠져 그대로 남음
라벨 실험은 실습에서 직접 해 봅니다

"라벨을 바꾸면 관리 대상에서 빠진다" 는 것은, 문제가 생긴 Pod 를 서비스에서 떼어 내 조사할 때 실무에서도 쓰는 요령입니다.

스케일링

replicas 숫자만 바꾸면 됩니다.

방법 명령
선언형 (권장) YAML 의 replicas: 5 로 고치고 kubectl apply -f
명령형 (급할 때) kubectl scale deployment guestbook --replicas=5

트래픽에 따라 자동으로 늘리고 줄이는 것(HPA)은 10주차에 합니다.


4. 롤링 업데이트: 하나씩 바꿔 끼우기

이미지를 v1 → v2 로 바꾸고 apply 하면, Deployment 는 새 ReplicaSet 을 만들고 조금씩 옮겨 갑니다.

flowchart TB
    S0["시작
v1 ●●● / v2 (없음)"] --> S1["① v2 1개 추가
v1 ●●● / v2 ●"] S1 --> S2["② v2 준비되면 v1 1개 종료
v1 ●● / v2 ●"] S2 --> S3["③ 반복
v1 ● / v2 ●●"] S3 --> S4["완료
v1 (0개, 이력용으로 남음) / v2 ●●●"]

속도와 안전의 조절: maxSurge, maxUnavailable

설정 (기본값) 의미 replicas 3 일 때
maxSurge: 25% 업데이트 중 원하는 개수보다 최대 몇 개 더 띄울 수 있나 3 × 25% = 0.75 → 올림 1개 (최대 4개까지)
maxUnavailable: 25% 업데이트 중 최대 몇 개까지 모자라도 되나 3 × 25% = 0.75 → 내림 0개 (항상 3개 유지)

그래서 replicas 3 의 기본 동작은 "1개 추가 → 준비되면 1개 종료" 를 반복합니다. 실습에서 kubectl get pods -w 로 이 순서를 직접 봅니다.

다른 전략: Recreate

strategy: type: Recreate 로 설정하면 전부 끄고 → 전부 새로 켭니다. 잠깐 서비스가 끊기지만, 두 버전이 동시에 돌면 안 되는 앱에 씁니다.


5. 배포 이력과 롤백

5-1. 이력에 메모 남기기

metadata.annotations 의 kubernetes.io/change-cause 에 적은 내용이 배포 이력에 남습니다.

$ kubectl rollout history deployment/guestbook
REVISION  CHANGE-CAUSE
1         v1 최초 배포
2         v2 배포 (초록)
3         v9 배포 (실수)

5-2. 잘못된 배포는 어떻게 되나 (실습에서 직접 겪음)

존재하지 않는 이미지 v9 를 배포하면:

NAME                         READY   STATUS         RESTARTS   AGE
guestbook-5c96fffb47-p5pgw   0/1     ErrImagePull   0          30s   ← 새 버전 1개: 실패
guestbook-5f994cddb4-c566p   1/1     Running        0          32s   ← 기존 v2 3개: 그대로 서비스 중
guestbook-5f994cddb4-f89d9   1/1     Running        0          31s
guestbook-5f994cddb4-q74qh   1/1     Running        0          33s
롤링 업데이트의 안전장치

새 Pod 가 준비(Ready)되지 않으면 기존 Pod 를 내리지 않습니다. 배포가 실패해도 서비스는 계속 됩니다. 사람이 상황을 보고 롤백하면 됩니다.

5-3. 롤백

방법 명령 언제
바로 전 버전으로 kubectl rollout undo deployment/guestbook 급할 때
특정 버전으로 kubectl rollout undo deployment/guestbook --to-revision=1
YAML 을 고쳐서 다시 apply (권장) 파일의 이미지를 되돌리고 kubectl apply -f 평소
rollout undo 후에는 YAML 파일도 맞춰 두세요

undo 는 클러스터만 되돌리고 내 YAML 파일은 그대로입니다(파일에는 여전히 v9). 다음에 무심코 apply 하면 또 v9 가 배포됩니다.
실제로 kubectl 도 경고를 띄웁니다: Rolling back will not update the kubectl.kubernetes.io/last-applied-configuration annotation ...
실무에서는 "파일(Git)이 진실" 이 되도록, 파일을 고쳐 apply 하는 방식으로 되돌립니다(10주차 GitOps 맛보기).


핵심 요약

7주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 관계        Deployment(버전) → ReplicaSet(개수) → Pod(실행)
② 핵심 필드    replicas / selector.matchLabels / template(Pod 설계도)
               selector 와 template 의 라벨은 같아야 한다
③ 자가 치유    "라벨 맞는 Pod 를 세고, 모자라면 만든다" → 죽어도, 노드가 고장 나도 복구
④ 스케일       replicas 숫자만 바꾼다 (apply 또는 kubectl scale)
⑤ 롤링 업데이트 새 ReplicaSet 을 만들고 하나씩 교체 → 무중단
               새 Pod 가 준비되지 않으면 옛 Pod 를 내리지 않는다 (안전장치)
⑥ 롤백        kubectl rollout undo  (그다음 YAML 파일도 꼭 맞춰 두기)

참고 자료

더 깊이 보고 싶다면 (볼트 내 정리 노트):

공식 문서:


네비게이션

이전 목록 다음
◀ 6주차 실습 목록으로 7주차 실습 ▶